-----------------------
Unread Plugin: 
Released: 12:49 11/01/2006
Version: 1.0
LDU version: 802
-----------------------
This plugin shows which active topics you have read. It also shows which sections are
active and how many unread active topics you have in that section.

This plugin, infact my first ever bit of php coding, apart from 
reading the core files to see how php works, is intended to make things 
easier for users to quickly find which topics are new , while they are in the forums
and which topics they have already read, even if they did not reply.

This plugin, has not been tested much at all, I release it for people to
use and test. I have no deep knowledge of coding, so it probably has bugs. 
if you find/have any problems, please let me know, even if you do not intend
to carry on using the plugin. This helps me learn, Fix things for other users
who do wish to also learn or get use from this plugin.


------
Thanx:
------
Thank you to neocrome and LDU for the CMD.
Thank you to Spartan for starting me off with his example of one of the
features of this plugin. 

http://www.neocrome.net/forums.php?m=posts&q=17534

The active section icon, is just a plugin exact copy of what he posted above.

-----------------------
A little about cookies:
-----------------------
The plugin uses cookies for each user to remember when he.she has read active posts. 
if they has cookies dissabled, This will of course not work correctly.


---------------
How to install:
---------------
Place the 'unread' folder inside your "plugins/extended/" directory:

Add the tags to your skin tpl files. Information on each tag is available below.

If you are using the tag 'FORUMS_SECTIONS_ROW_STATUS_ICON', Create two new icons,fsposts_new.gif and fsnoposts_new.gif.
Place these inside your skins/$skin/img/ folder.

once the above has been compleated. On your website, Go to Administration-Extended plugins.
Find the No INstalled plugin @unread', Click on unread, Then scroll down and press Install-All.

There is no Configuration options available at this time.


---------------------
Forums Sections tags:
---------------------

FORUMS_SECTIONS_ROW_STATUS_ICON
-------------------------------
This will contain a image url from skins/img of either fsposts_new.gif or fsnoposts_new.gif. 
fsnoposts_new, Would mean no new posts in this section. fsposts_new would mean new posts in this section.

You need to create two img's, one named fsnoposts_new.gif and another named fsposts_new.gif. These need to be placed inside
your "skins/$skin/img/" folder.

Then in your forums.sections.tpl, you must add somewhere the tag {FORUMS_SECTIONS_ROW_STATUS_ICON}. You could put this in the place
of the old {FORUMS_SECTIONS_ROW_CAT_ICON} tag.


FORUMS_SECTIONS_NEW_NUMBER
--------------------------
This will contain the number of unread active topics. If the user has not yet posted, this will now show any, because they would otherwise
all be shown as active. Active posts, Posts newer than when yo last logged in, Will be counted. The number will only be shown if the number
of unread active topics is above 0. The word 'unread' is appended to the number if the number is above 0.


FORUMS_SECTIONS_FONT_WEIGHT
--------------------------
This will contain either, 'bolder', or 'normal'. Any section that has unread active topics will contain bolder, sections without
unread active topics will contain 'normal'. You can use this tag in your tpl file to show bold the sections with
unread active topics. To use it, in forums.sections.tpl:

i did the following:

		<td>
		<h2 style="margin:0;font-weight:{FORUMS_SECTIONS_FONT_WEIGHT}">
		<a href="{FORUMS_SECTIONS_ROW_URL}">{FORUMS_SECTIONS_ROW_TITLE}</a></h2>
		{FORUMS_SECTIONS_ROW_DESC}
		<br><b>{FORUMS_SECTIONS_NEW_NUMBER}</b>
		</td>

notice, this line:

		<h2 style="margin:0;font-weight:{FORUMS_SECTIONS_FONT_WEIGHT}">


The font weight of the sections title, will be the font weight either 'normal' or 'bolder' depending on the state of the
sections topics.


---------------------
Forums Sections tags:
---------------------

FORUMS_TOPICS_FONT_WEIGHT
-------------------------
This will contain either, 'bolder', or 'normal', depending if this topic is active and unread. If the topic is active,
has been posted after the time of the users last login, and the post has not been read already, since it's post. Then the 
topic tag FORUMS_TOPICS_FONT_WEIGHT will be bold. if the topic is not active or is active and has been read, the tag FORUMS_TOPICS_FONT_WEIGHT
will contain 'normal'. This is usefull, as it makes it clear which topics are active while browsing the forums and makes it clear what
or which topics you have currently already read.

To use this tag, You have to place it in your forums.topics.tpl. You should place it as the font-weight: of a topic title.

This is an example from my forums.topics.tpl, DOnt ask my why it has <strong>, I dont eve know what <strong> does. I dont know webcode yet.

		<td>
		<strong style="font-weight:{FORUMS_TOPICS_FONT_WEIGHT};">
		<a href="{FORUMS_TOPICS_ROW_URL}">{FORUMS_TOPICS_ROW_TITLE}</a>
		</strong>




--------------------
COntact information:
--------------------
If you have any reports, questions, Feel free to contact me.

You can find me at Neocrome: http://www.neocrome.net/users.php?m=details&id=9068
E-mail: Elgan.sayer@gmail.com

